home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr10 / diff101.zip / DIFF.DOC < prev    next >
Text File  |  1993-06-01  |  18KB  |  632 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                                                      DIFF
  18.         _________________________________________________________________
  19.  
  20.                                                   File Difference Utility
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                                     U S E R S   G U I D E
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                                              Version 1.01
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                                                                ┌────────┐
  53.                                       C.SITTE SOFTWARETECHNIK  │c.sitte │
  54.                                                   Postfach 42  │software│
  55.                                       A-5025 Salzburg/Austria  │technik │
  56.                                                                └────────┘
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         EDITION
  69.  
  70.         May 1993
  71.         Copyright 1993 by C.Sitte Softwaretechnik
  72.         All rights reserved
  73.  
  74.  
  75.  
  76.         NOTICE
  77.  
  78.         This documentation is based on the software revision V1.01 of May
  79.         1993.  The  information  in this document is  subject  to  change
  80.         without notice. C.Sitte Softwaretechnik assumes no responsibility
  81.         for any errors that may appear in supplied materials or programs.
  82.  
  83.  
  84.  
  85.         SHAREWARE INFORMATION
  86.  
  87.         DIFF  is distributed under the shareware marketing concept.  This
  88.         means  that you can try the program for a limited amount of  time
  89.         to see if it meets your needs.  After the trial period,  you  are
  90.         required  to register and pay the registration fee or stop  using
  91.         it.
  92.         Shareware is a distribution method,  NOT a type of software.  The
  93.         primary  difference between shareware and retail software is that
  94.         with shareware you know if it fits your needs BEFORE you pay  for
  95.         it.
  96.         The  shareware  system and the continued availability of  quality
  97.         shareware products depend on your willingness to register and pay
  98.         for  the shareware you use.  It's the registration fees  you  pay
  99.         which  allow us to support and continue to develop our  products.
  100.         Please  show  your  support for shareware  by  registering  those
  101.         programs you actually use and by passing them on to others.
  102.  
  103.  
  104.  
  105.         LICENSE
  106.  
  107.         Non-registered  users  are granted a limited license to try  DIFF
  108.         for  a  period  of four weeks.  After the trial  period  you  are
  109.         required  to  register and to pay the registration  fee  or  stop
  110.         using it.  The four week evaluation period is a legal requirement
  111.         based  on the license agreement,  NOT a time bomb inserted in the
  112.         program! DIFF will not stop working or cause any damage to itself
  113.         or your system at the end of the four week period.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                         T A B L E   O F   C O N T E N T S
  133.                         ---------------------------------
  134.  
  135.  
  136.         1.    INTRODUCTION . . . . . . . . . . . . . . . . . . . . .    1
  137.         1.1     PACKING LIST . . . . . . . . . . . . . . . . . . . .    1
  138.         1.2     DISTRIBUTION . . . . . . . . . . . . . . . . . . . .    1
  139.  
  140.         2.    USAGE. . . . . . . . . . . . . . . . . . . . . . . . .    2
  141.         2.1     ARGUMENTS. . . . . . . . . . . . . . . . . . . . . .    2
  142.         2.2     COMPARISON OPTIONS . . . . . . . . . . . . . . . . .    2
  143.         2.2.1     CASE INSENSITIVE COMPARE (/c). . . . . . . . . . .    2
  144.         2.2.2     IGNORE TRAILING BLANKS (/b). . . . . . . . . . . .    3
  145.         2.2.3     EXPAND TABS BEFORE COMPARING (/x). . . . . . . . .    3
  146.         2.2.4     IGNORE SPACES AND TABS (/s). . . . . . . . . . . .    3
  147.         2.2.5     TAB SIZE (/t##). . . . . . . . . . . . . . . . . .    3
  148.         2.2.6     DISPLAY WHOLE FILE (/a). . . . . . . . . . . . . .    3
  149.         2.2.7     OUTPUT WIDTH (/w##). . . . . . . . . . . . . . . .    3
  150.         2.3     DIFFERENCE DISPLAY . . . . . . . . . . . . . . . . .    3
  151.         2.3.1     Example. . . . . . . . . . . . . . . . . . . . . .    4
  152.         2.3.2     Redirection. . . . . . . . . . . . . . . . . . . .    4
  153.  
  154.         3.    WARRANTY . . . . . . . . . . . . . . . . . . . . . . .    5
  155.  
  156.         4.    ASP OMBUDSMAN STATEMENT. . . . . . . . . . . . . . . .    5
  157.  
  158.         5.    ORDER INFORMATION. . . . . . . . . . . . . . . . . . .    6
  159.  
  160.         6.    To help you - help us! . . . . . . . . . . . . . . . .    7
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.         DIFF - File Difference Utility                              V1.01
  192.  
  193.  
  194.         1.  INTRODUCTION
  195.  
  196.         DIFF  is  a DOS application wich displays two text files side  by
  197.         side.  Common  and  different sections are  clearly  marked  with
  198.         separator lines.
  199.         DIFF  is  especially useful for programmers who wants to see  the
  200.         differences between two versions of a source text file.  Tab size
  201.         and comparison options are configurable.
  202.  
  203.  
  204.         1.1  PACKING LIST
  205.  
  206.         Shareware  copies of DIFF may be "packaged" in a variety of  ways
  207.         depending on who distributed them.  Regardless of packaging,  the
  208.         following files should be included:
  209.  
  210.         DIFF    .EXE    DOS File Difference Utility
  211.         DIFF    .DOC    Documentation
  212.         ORDER   .FRM    Order Form
  213.         DESCRIBE.DOC    Product Description & Author Info
  214.         VENDOR  .DOC    Vendor/Distributor Information
  215.         FILE_ID .DIZ    Program Description for BBS's
  216.         !!READ  .!ME    General Info and Last Minute Information
  217.  
  218.  
  219.         1.2  DISTRIBUTION
  220.  
  221.         You  are encouraged to freely copy and distribute  DIFF  provided
  222.         that (see VENDOR.DOC for more information):
  223.  
  224.         1. No fee beyond normal media, duplication, and shipping costs
  225.            may be charged.
  226.  
  227.         2. It must be copied in unaltered form complete with this license
  228.            and copyright information.
  229.  
  230.         3. It is advertised as "shareware" and not as "free" or
  231.            "public domain" software.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                                         1
  253.  
  254.         DIFF - File Difference Utility                              V1.01
  255.  
  256.  
  257.         2.  USAGE
  258.  
  259.         When  the  DIFF program is started  without  any  arguments,  the
  260.         following text appears:
  261.  
  262.          DIFF V1.01 #000000701196A - List File Differences
  263.          (C) Copyright 1993 C.Sitte Softwaretechnik, All rights reserved.
  264.          * UNREGISTERED EVALUATION VERSION *
  265.          Enter "diff /r" for registration info
  266.  
  267.          usage is: diff [/options] file1 [file2]
  268.          options:
  269.            /c     case insensitive compare
  270.            /b     ignore trailing blanks
  271.            /x     expand tabs before comparing
  272.            /s     ignore spaces and tabs
  273.            /t##   tab size (1..19, default=8)
  274.            /a     display whole file
  275.            /w##   output width (20..199, default=79)
  276.            /r     registration information
  277.            /?     help
  278.          file2 can be a drive or directory name
  279.  
  280.  
  281.         2.1  ARGUMENTS
  282.  
  283.         The DIFF program takes one or two filename arguments. If only the
  284.         first argument is given, the second filename is assumed to be the
  285.         same  filename  as the first argument,  but with an extension  of
  286.         ".BAK".
  287.         The second filename can be a drive or directory name.  That means
  288.         that the file with the first filename is compared to a file  with
  289.         the same name in the specified drive/directory.
  290.  
  291.  
  292.         2.2  COMPARISON OPTIONS
  293.  
  294.         There are the following options available wich must be  specified
  295.         before  the filename(s).  Options start with the slash  character
  296.         ("/")  as  an  option identifier and are followed  by  an  option
  297.         character  which  can be written in lower- or uppercase.  Two  or
  298.         more  options  could be combined in one  option  argument  (e.g.:
  299.         DIFF  /a /bx file1).  Options with numeric arguments must be  the
  300.         last option in a combined option argument.
  301.  
  302.         The following options are available:
  303.  
  304.  
  305.         2.2.1  CASE INSENSITIVE COMPARE (/c)
  306.  
  307.         Upper- and lowercase is ignored on comparison.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.                                         2
  316.  
  317.         DIFF - File Difference Utility                              V1.01
  318.  
  319.  
  320.         2.2.2  IGNORE TRAILING BLANKS (/b)
  321.  
  322.         One  or  more blanks at the end of a line are ignored during  the
  323.         comparison.
  324.  
  325.  
  326.         2.2.3  EXPAND TABS BEFORE COMPARING (/x)
  327.  
  328.         Tab characters (hex 09) in the text are expanded to the number of
  329.         spaces  specified in the "Tab size" (/t) option (default=8)  wich
  330.         are neccessary to reach the next tab stop.
  331.         This option will be ignored, if the "Ignore spaces and tabs" (/s)
  332.         option is selected.
  333.  
  334.  
  335.         2.2.4  IGNORE SPACES AND TABS (/s)
  336.  
  337.         Tab characters and spaces will be ignored on comparison.
  338.  
  339.  
  340.         2.2.5  TAB SIZE (/t##)
  341.  
  342.         The  tabsize  (number of spaces between tab stops) is  selectable
  343.         between  1  and 19 spaces.  The default size is  8  spaces.  This
  344.         option influences the file comparison,  if the "expand tabs" (/x)
  345.         options is also set.
  346.         Tabs are expanded to the given number of spaces in the difference
  347.         display.
  348.  
  349.  
  350.         2.2.6  DISPLAY WHOLE FILE (/a)
  351.  
  352.         The whole files (not only the different sections) are displayed.
  353.  
  354.  
  355.         2.2.7  OUTPUT WIDTH (/w##)
  356.  
  357.         The line width of the difference display can be selected  between
  358.         20 and 199 characters. The default width is 79 characters.
  359.  
  360.  
  361.  
  362.         2.3  DIFFERENCE DISPLAY
  363.  
  364.         By default, only the different sections between the two files are
  365.         displayed, separated by separator lines. The files are shown side
  366.         by side. The first file is shown at the left side, and the second
  367.         file at the right side. Each line has a line number. Missing line
  368.         numbers means that there is no line in the according file.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.                                         3
  379.  
  380.         DIFF - File Difference Utility                              V1.01
  381.  
  382.  
  383.         2.3.1  Example
  384.  
  385.           C> diff /t3 /w63 test.cpp
  386.  
  387.  
  388.           DIFF V1.01 #000000701196A - List File Differences
  389.           (C) Copyright 1993 C.Sitte Softwaretechnik, All rights reserved.
  390.           * UNREGISTERED EVALUATION VERSION *
  391.           Enter "diff /r" for registration info
  392.           comparing TEST.CPP with TEST.BAK
  393.           ---------------------------------------------------------------
  394.            1: // diff.cpp -- main progra   1: // diff.cpp - main program
  395.           ---------------------------------------------------------------
  396.            4:
  397.           ---------------------------------------------------------------
  398.            7: extern "C" {                 6: extern "C" {
  399.           ---------------------------------------------------------------
  400.                                           15: //////////////////////////
  401.           ---------------------------------------------------------------
  402.           54:             strncpy (LINE1  54:             strncpy (line1
  403.           ---------------------------------------------------------------
  404.           64:             DIFFSTRING  st  64:             DIFFSTRING str
  405.           ---------------------------------------------------------------
  406.           72:          printf ("--------  72:          printf ("--------
  407.           73:             "-------------
  408.  
  409.  
  410.  
  411.         2.3.2  Redirection
  412.  
  413.         The  output  of the comparison can be redirected into a  file  or
  414.         piped into another program.
  415.  
  416.           C> diff test.cpp test.old > test.dif
  417.  
  418.           C> diff test.cpp d: | more
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.                                         4
  442.  
  443.         DIFF - File Difference Utility                              V1.01
  444.  
  445.  
  446.         3.  WARRANTY
  447.  
  448.         C.SITTE SOFTWARETECHNIK MAKES NO WARRANTY OF ANY KIND, EXPRESS OR
  449.         IMPLIED,   INCLUDING  WITHOUT  LIMITATION,   ANY  WARRANTIES   OF
  450.         MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
  451.         C.SITTE  SOFTWARETECHNIK  SHALL  NOT BE LIABLE FOR  ANY  DAMAGES,
  452.         WHETHER DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL ARISING FROM A
  453.         FAILURE  OF THIS PROGRAM TO OPERATE IN THE MANNER DESIRED BY  THE
  454.         USER.  C.SITTE SOFTWARETECHNIK SHALL NOT BE LIABLE FOR ANY DAMAGE
  455.         TO DATA OR PROPERTY WHICH MAY BE CAUSED DIRECTLY OR INDIRECTLY BY
  456.         USE OF THE PROGRAM.
  457.         IN NO EVENT WILL C.SITTE SOFTWARETECHNIK BE LIABLE TO YOU FOR ANY
  458.         DAMAGES,  INCLUDING  ANY  LOST PROFITS,  LOST  SAVINGS  OR  OTHER
  459.         INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR
  460.         INABILITY TO USE THESE PROGRAM,  EVEN IF C.SITTE  SOFTWARETECHNIK
  461.         HAS  BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES,  OR FOR ANY
  462.         CLAIM BY ANY OTHER PARTY.
  463.  
  464.  
  465.         4.  ASP OMBUDSMAN STATEMENT
  466.  
  467.         This  program  is  produced  by a member of  the  Association  of
  468.         Shareware  Professionals  (ASP)  ASP wants to make sure that  the
  469.         shareware principle works for you. If you are unable to resolve a
  470.         shareware-related  problem with an ASP member by  contacting  the
  471.         member directly,  ASP may be able to help.  The ASP Ombudsman can
  472.         help  you  resolve a dispute or problem with an ASP  member,  but
  473.         does not provide technical support for members' products.  Please
  474.         write  to  the ASP Ombudsman at 545  Grover  Road,  Muskegon,  MI
  475.         49442-9427,  USA or send a CompuServe message via CompuServe Mail
  476.         to ASP Ombudsman 70007,3536.
  477.         The  Ombudsman may be contacted by FAX by sending to the ASP  FAX
  478.         number:  (616)  788-2765.  In  communication with  the  Ombudsman
  479.         please include a telephone number and/or FAX if available.
  480.  
  481.  
  482.  
  483.                                              ┌───────┐
  484.                                         ┌────┴──┐    │                (R)
  485.                                       ──│       │    │───────────────────
  486.                                         │  ┌────┴──┐ │  Association of
  487.                                         │  │       │─┘  Shareware
  488.                                         └──│   o   │    Professionals
  489.                                       ─────│   │   │─────────────────────
  490.                                            └───┴───┘    MEMBER
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                         5
  505.  
  506.         DIFF - File Difference Utility                              V1.01
  507.  
  508.  
  509.         5.  ORDER INFORMATION
  510.  
  511.         The registration fee for a single copy of DIFF is US$ 15.-.
  512.         Payment of this fee entitles you to:
  513.  
  514.         *  Disk with the latest version of DIFF which does not display
  515.            the shareware notices and registration reminders.
  516.  
  517.         *  Free support by electronic mail or by mail for the
  518.            first six month after payment.
  519.  
  520.         *  Additional disk labels for the number of ordered copy
  521.            licences.
  522.  
  523.         *  Notification of the next major upgrade.
  524.  
  525.         *  Shareware versions of other products of
  526.            C.Sitte Softwaretechnik
  527.  
  528.         The  following  per-unit prices apply for registration of one  or
  529.         more copies of DIFF on the same order form:
  530.  
  531.             1           US$ 15.-
  532.             2 -  9      US$ 10.-  (-35%)
  533.             10+         (negotiable)
  534.  
  535.         It  is also possible to obtain an additional site  licence  (copy
  536.         license).  A minimum of one disk must be ordered. The licensee is
  537.         responsible  for  duplicating  the diskette as  needed,  and  for
  538.         ensuring  that  the number of installed copies is  not  exceeded.
  539.         Additional  disk labels for the number of ordered  copy  licences
  540.         will be delivered.
  541.  
  542.             25  User    US$ 120.-
  543.             50  User    US$ 200.-
  544.             100 User    US$ 320.-
  545.             100+        (negotiable)
  546.  
  547.         An additional shipping & handling charge of US$ 5.- must be added
  548.         to the total amount.
  549.  
  550.         Payments  can  be made by credit card  (MC/Visa/AmEx/JCB),  cash,
  551.         international postal money order or eurocheque.  If you use an US
  552.         check, please add another US$ 5.- for bank charges.
  553.  
  554.         The accompanying file ORDER.FRM includes a detailed order form.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.                                         6
  568.  
  569.         DIFF - File Difference Utility                              V1.01
  570.  
  571.  
  572.         6.  To help you - help us!
  573.  
  574.         If  you  have questions about the DIFF File  Difference  Utility,
  575.         please describe your problem as detailed as possible,  so that we
  576.         are able to simulate it according to your information.
  577.  
  578.         Send this information to us via mail or electronic mail:
  579.  
  580.         Mail:     C.SITTE SOFTWARETECHNIK
  581.                   Postfach 42
  582.                   A-5025 Salzburg, AUSTRIA
  583.  
  584.         Electronic Mail:
  585.                   CompuServe: 73030,1070
  586.                   Internet  : 73030.1070@compuserve.com
  587.  
  588.                   X400      : Country=us
  589.                               ADMD=CompuServe
  590.                               PRMD=csmail
  591.                               DDA Type=id
  592.                               DDA Value=73030.1070
  593.  
  594.                   MCI users should enter these values
  595.                   at the following prompts:
  596.                          To : Chris Sitte (ems)
  597.                          EMS: CompuServe
  598.                          MBX: p=csmail
  599.                          MBX: d=id=73030.1070
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.         REVISION HISTORY
  609.  
  610.         v1.01  May/93          Initial shareware release of DIFF
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.                                         7
  631.  
  632.